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I . INTRODUCTION 



The SMS FV7D controller can be used with tv;o flcppy disk drives in COMPATIBLE mode 
using the RX02 driver (DYDRV) supplied by DIGITAL with the RSX-llM Operating 
System. In tliis mode, the device will perform exactly as an RX02. However, in 
order to take advantage of the significant functional and performance advantages 
of the FW series of controllers when cperated in EXTENDED mode, it is necessary 
to use the SMS-supplied FW driver (FVdDRV) . With the inclusion of FW: , the 
RSX-llM user has the follcwing advanced capabilities: 

* Ability to read and write RXOl, RX02, and RX03 diskette 
formats on a per unit basis in the same manner as the RX02 
driver. 



* Ability to read and write IBM single sided and double sided 
diskettes on a per unit basis for all single density and 
double density formats. 

* Ability to read and write one or two V^inchester fixed disks 
using the same driver as the floppy disk units. 

* Ability to DMA transfer up to 32K words of data in a single 
I/O operation without incurring any Executive overhead, in any 
of the above flcppy and Winchester formats. 

* Ability to use IBM formatted diskettes as FILES-11 volumes, 
allowing 1216 blocks of storage per diskette with single sided 
drives, or 2432 blocks of storage with double sided drives 
(conpared with 988 blocks allowed using the RX02 format) . 

* Ability to format diskettes in any of the IBM or DEC data 
formats described above. 

* Ability to use the Winchester or IBM format flcppy units as 
the system device (that is, the FWD controller can boot 
RSX-llM frcm pcwer-up without another FILES-11 device present 
on the user ' s system) . 

* Ability to dynamically change the diskette format either by an 
application program or by using a supplied utility program 
(MCR function) . 

* Support for 22-bit addressing with the appropriate hardware 
configuration. 
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A. FW: DRIVER DESIGN MD IMPLEME3SITATICN 

The FW: driver v/as designed to provide for all of the RSX-llM sysgen options 
supported by DEC-written mass storage device drivers by means of standard 
conditional assembly parameters. i?^plicable options are 11/70 Unibus mapping, 
LSI-11 processor, error logging, memory management, patient power fail recovery, 
and multiple controllers. 

In addition, the inherent capabilites of the FWD controller in extended mode were 
exploited to the fullest, resulting in an assembly size shorter than would 
otherwise be possible. Specifically, for device-independent I/O functins (lO.RLB 
and lO.WLB), the controller hardv^are performs the logical block to track/sector 
conversion, the interleave mapping, the error retry policy handling, 
end-of-volume detection, illegal block number detection, and track re-seek 
handling. 

The coding standard followed was that of DEC's RSX-llM development group (a 
modified version of that promulgated in Appendix E of the MACRO-11 Reference 
Manual). If a detailed understanding of the functional aspects of this driver 
(or any others on the user's system) is required, the RSX-llM Guide to Writing an 
I/O Driver can be used as a reference. This manual contains an ^pendix defining 
the symbolic terms used in the driver source code. 



B. 22-BIT ADDRESSING 

RSX-llM V4.0 supports 22-bit extended memory. It is possible to configure a 
system with 1/2 megatyte or more of memory. Contact SMS for further details. 
The ccrrtplete RSX-llM V4.0 distribution from SMS contains a bootable floppy that 
supports 22-bit addressing. 

C. FW: LIMITATIONS 

The FW driver supports all standard DEC utilities with the following exceptions: 

Bootable disk save and compress (DSCS8.SYS) is not supported. Disk backup 
is performed ty the disk save and cctnpress task (DSC.TSK), BRU.TSK, or 
BMJ.TSK. 

Bootable PRESRV.SYS or FMT.TSK are not supported for the m driver. Use 
FMJ.TSK or the SMS installation and test floppy to format disks. 

D. CARTRIDGE MAGNETIC TAPE (MS:) 

RSX-llM V4.0 supports the SMS cartridge tape. The tape unit is TS-11/TSV05 
cotpatible and uses the lys device handler. 
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II. INSTALIATICN OF THE DRIVER MD UTILITY 



If the conplete RSXllM floppy distribution was purchased from Scientific Micro 
Systems, proceed to section III. 

If the complete RSX-llM tape distribution was purchased from Scientific Micro 
Systems, proceed to Section IV. 

This section describes the installation of the F\V: driver and FW utility. 

The distribution kit supplied is for a host system operating RSX-llM from a 
DEC-supported system device. The medium is one RX02-cciTpatible diskette 
containing all requisite sources. This diskette is readable using the RX02 
driver DYDRV and the SMS FWDOlOO hardware controller, or with the DYDRV and the 
RX211 hardware controller. 

With the host system, cm RSX-llM user may add the FW driver as an auxilliary 
FILES-11 device to his present system or build a target system with the FW driver 
as the system device. 

A utility program (task) is also supplied, in source form, with the distribution 
kit. This task (FWU) may be installed on the host or target system as an IVKZlR 
function, or else invoked with the RUN MCR function. FliJU provides a convenient 
means for dynamically changing diskette formats in order to acccmmodate the 
selective reading and writing of various IBM or DEC diskette formats, plus 
provides additional device control capabilities. (See Section IV.) 
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A. DISTRIBUTION DISKETTE CONTENTS 



The distribution diskette contains the follcwing files. 
Directory DYO:C1,20J 



SAVBLD.ELD;! 


;SAV 


BUILD 


BOOBLD.BLD;! 


7 BOO 


BUILD 


Directory DYO:Cl,24] 






SAVBLD.CMD; 1 


;SAV 


BUILD 


BDOBLD.CMD; 1 


;B00 


BUILD 


SAVBLD.ODL;! 


;SAV 


ODL 


BOOBLD.ODL7I 


;B00 


ODL 



Directory DY0:Cl,54] 

FLX.TSK;1 

CFL.TSK;! 

Directory DYD: [200,200] 
FWGEN.ayiD;l 
FWINS.CMD; 1 

Directory DY0:C1,24] 

PREFW.MAC;1 

FWDRV.MAC;1 

FWTAB.MACjl 

FWU.MAC;1 

EW.CMD;1 

FWU.CMD;! 

FWUBLD.CMD7I 

FWDRVBLD.CiyiD;l 

SAVFW.MAC;1 

S AVB00BLD.CMD 7 1 

SAVnVASM.CMD7l 

CREATEWIN.CMD? 1 

CREATEFLP.CM)7l 

CREATEDIS.CMD 7 1 

CREATERXO.CMD7I 

RSX.CMD7I 

EFWII.CNF7I 

DEVSMI.CNF7I 

EFWIIASM.CMD7I 

DEVSM1ASM.CMD 7 1 

FWERRINS.CMD7I 

GETDEV.OBJ7I 

FIXFLX.CiyiD7l 

MSDRVASM.CMD7I 

MSTABA^.CMD7l 

MSDRIVER.CMD7I 

MSDRVBLD.CMD 7 1 

Directory DYO: [11,10] 

MSDRV.MAC7I 

MSTAB.MAC7I 



7FLX FOR m 



7USED TO INSTALL M 
7 BUILD AFTER SYSGEN 



m CONDITIONAL ASSEMBLY PREFIX FIIuE 

FW DRIVER SOURCE 

FW T?VBLE SOURCE 

BW UTILITY SOURCE 

BUILD FW DRIVER 

BUILD FW UTILITY 

FWU TKB 

FW DRIVER TE^ 

SPECIAL DRIVER FOR SAV AND BOO 
SAVFV7 TKB 
SAVFW ASSEM. 

SAMPLE COMMAND TO CREATE BOOTABLE WINC 

SAMPLE COMMAND TO CREATE BOOTABLE FLOPPY 

SAMPLE COMMAND TO CREATE DISTRIBUTION 

SAMPLE COMMAND TO CREATE DRIVER 

VMR CaiMAND FILE 

ERRLOG 

ERRLOG 

ERRLOG 

ERRLOG 

ERRLOG 

FILEX 

FILEX 

BUILD MS DRIVER 
BUILD MS DRIVER TABLE 
BUILD MS DRIVER COMMAND FILE 
BUILD MS DRIVER TECB 



7m DRIVER SOURCE 
7MS TABLE SOURCE 
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B. SUPPLIER mV USER CCNSIDERATICNS 

It is assumed that the RSXllM syston supports loadable drivers. Executive space 
and runtime overhead required to support, loadcible drivers is almost zero. Disk 
space required for the actual support tasks LOA and UNL is minimal. For the 
purposes of future updates, not only of FWDRV but also of DEC-supplied drivers, 
the cotplexity of installing or changing a driver is increased at least an order 
of magnitude if Loadable Driver support is not included. 

C. DRIVER GCNDITICNALS 

RSX-llM drivers contain many conditional assembly parameters vhich are associated 
with Sysgen options selected by the user or distributed by DIGITAL. These 
conditionals correspond to questions asked by Sysgen Phase One and should be 
known to the user. Care should be taken to insure that the conditional assembly 
prefix file used when assoribling the driver agrees with that used when the 
Executive of the target system was assesribled. If it does not, one of the 
following will happen: 

1) The task builder (TKB) will issue error messages indicating that sane 
global is undefined. 

2) The load task (LOA or VMR) will indicate that sane driver feature is 
inconsistent with the Executive symbol table file. 

3) The system will crash vjhen the driver is loaded or v^en a disk access 
is atterrpted. 
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D. INSTALLATIOSf OF R7: DRIVER 

The follcwing procedure should be used to generate and install supplied software. 
Insert the RX02 diskette into SMS supplied floppy unit. Execute the follcwing 
canmands. Your responses are underlined: 

SET /UIC=[200,2003 
>MOU DY0;/OVR 
> PIP SYO ; /NV=DYO lEWINS .CMP 
> @FWINS 

>;THIS OOMMfiND PERFORMS THE FOUXWING FUNCTION: 



>; 1-CREATE TBIE NECESSARY UFD'S 

>; 2-TRANSFER ALL FILES FROM THE RX02 FLOPPY DISTRIBUTION TO 

YOUR SYSTEM DISK. 

> ; 3-ALLCV7 YOU TO EDIT THE m OONDITICNAL FILE "PREFW.MAC" 

>; 4-ASSMBLE AND TASK BUILD THE "FW" DRIVER 

>; 5-ASSEMBLE AND TASK BUILD THE PW UTILILTY "FWU.TSK" 

>; 6-RUN VMR TO INSTALL NEW "FW" DRIVER AND FWU UTILITY 

>; 7-TASK BUILD A NEW VERSION OF "SAV.TSK" 

>; 8-TASK BUILD A NEW VERSION OF "BOO.TSK" 



>* DO mi WANT TO COSITINUE? [Y/NJ : Y 

>; 
>; 

>INS ?MAC 
>INS $TKB 
>INS $VMR 
>SET /UIC=C1,54J 

>;THE POLLCWn^G FILES MJST BE PRESENT ON YOUR SYSTEM DISK BEFORE 
WE CAN PROCEED. 



>; 

>; 1-[11,10]RSXMC.MAC (YOUR SYSTEM CONDITIOSIAL AJSSEMBLE FILE) 

>; 2-[l,l]EXEMC.MLB (EXEC MACRO LIBRARY) 

>7 3-Ll/l]RSXMAC.SML (SYSTEM MACRO LIBRARY) 

>; 4-Cl,l]EXELIB.0LB (EXEC LIBRARY) 

>; 5-[l,l]SYSLIB.0LB (SYSTEM LIBRARY) 

>; 6-[l,54]RSXllM.STB (SYMBOL TABLE) 

>; 7-[l,24]SAV.OLB,B0O.OLB,MCR.OLB 

>; 



>; ESPECIALLY MAKE SURE THAT THE PROPER RSXMC.MAC IS IN [11,10] 

>; 

>*ARE ALL THE ABOVE FILES PRESENT IN THE PROPER UIC? [Y/N]: Y 
>7 

>;WE ARE ASSUMING 1HAT IHE PROPER INPUT DEVICE DRIVER IS LOADED' i I I 
>* WEiAT IS THE INPUT FLOPPY DEVICE NAME (I.E. DYO: ,FV^: ,ETC) [S]: DYO : 
>DMO DYO:/DEV 
>ALL DYO: 

>MOU DY0:/OVR 

>; 

>PIP SYO: [*, *]/UF/PO/NM/NV=DYO: [*,*]*. */FO/m'i 

>; 

>DMO DYO:/DEV 
>SET /UIC=C1,54] 
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>; 

>;YOU MUST EDIT THE FW DRIVER GONDITICmL ASSEMBLY FIIE TO SPECIFY TOE 

>;TYPE OF WINCHESTER DISK THAT YOU HAVE ON YOUR SYSTHVI. 

>; (THE DEFAULT WINCHESTER TYPE IS A QUANTUM 2020 WITH MULTIPLE 

>; LOGICAL VOLUMES ENABLED FOR 4 DEVICES. IF YOUR PHYSICAL 

>; WINCHESTER IS A QUANTUM 2020,2040, OR 2080 IT IS REGOMMEtlDED 

>; THAT YOU NOT EDIT THIS FILE OR CFIANGE ITS DEFAULTS. A QUANTUM 

>; 2040 BY DEFAULT WILL BE TWO LOGICAL 20MB DEVICES OF EQUAL, 

>; SIZE. A QUANTUM 2080 BY DEFAULT WILL BE FOUR LOGICAL 20MB 

>; DEVICES OF EQUAL SIZE). 

>7 

>* DO YOU WANT TO EDIT TOE FW OaSTDITIONAL ASSEMBLY FILE? [Y/Nj: N 
>;IT MAY BE NECESSARY TO EDIT THE FW DRIVER TASK BUILD COMMAND FILE 
>;T0 CHANGE THE NAME OF TOE PARTITIOSr. 

>; 

>* DO YOU WANT TO EDIT TOE TASK BUILD COMMAND FILE FOR THE BV7 

DRIVER? [YAT]: N 
>MAC [1 , 124]FWDRV=[ 11, 10]RSXMC/PA: 1 , [ 1 , 1]EXEMC/ML, [1 , 124]PREFW, FWDRV 
>MAC [l,124]FWrAB=Cll,10]RSXMC/PA:l, C1,1]EXEMC/ML, [l,124]PREFW,FWrAB 
>TKB @[1,124JFI^RVBLD.CMD 
>; 

>;IT mY BE NECESSARY TO EDIT THE FW UTILITY TASK BUILD COMMAND FILE. 
>;T0 CHANGE THE NA^4E OF THE PARTITIOJ. 

>; 

>* DO YOU WANT TO EDIT TOE BUILD FILE FOR THE PW UTILITY? [Y/Nj : N 
>MAC [1 , 124]FWU, FWU/-SP=C1 , 1]EXEMC/ML, [11 , 10]RSXMC/PA: 1 , [1 , 124]PREFW,FV;U 
>TKB @[1,124]FMJBLD 
>TIM 
>. 

>;YDU WILL NOW HAVE A CHANCE TO RUN VMR TO LQA THE NBV DRIVER 
>;AND INSTALL THE NEW COPY OF THE UTILITY PROGRAM. EXECUTE THE 
>;POLLCWING COMMANDS Wm YOU ARE PROMPTED BY VMR: 

>; 
> 
>; 
> 

> 

> 

> 

>; 

>VMR 

Enter filename: RSXllM 
VMR> UNL DY ; 
VMR> LOA EW;/PAR=GEN 
VMR> INS FWU 
VMR>Z 
>7 

>; 

>;IF YOU DESIRE TO CREATE A BOOTABLE SYSTEM DEVICE ON THE SMS SUPPLIED 
>;DISK, YOU MUST REBUILD "SAV.TSK" AND "BOO.TSK". IF YOU WANT 
>7T0 USE TOE SMS SUPPLIED DISK OSILY AS A PERIPHERAL DEVICE THEN 



ENTER FILENAME: RSXllM 

VMR>UNL DY: (IF DY: IS LOADED) 

Vm>LDA FW:/PAR==GEN (OR THE APPROPRIATE PARTITION) 

VMR>INS FWU 

VMR> (CCNTROL Z) 
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>;ANSV^ NO TO THE FOLLCWING QUESTION. ANSWER YES TO TEiE FOLLOWING 
>;QUESTiaj CNLY IF YOU ARE SURE OF WHAT YOU ARE DOING. IT IS 
>; RECOMMENDED THAT YOU BACK UP YOUR SYSTEM. 
> 7 BEFORE RE-BUILDING SAV AND BOO. 

>* DO YOU WANT TO REBUILD "SAV.TSK" AND "BOO.TSK"? [Y/N]: Y 

>ASN SYO:=TK: 

>AaSf NL:=MP: 

>SET /UIG=[1,24] 

>; 

>; Indirect cotimandfile to reassemble and rebuild SAVE and BOOT 
>; ~ use this file vhen you change f ran/to multiple logical volume 
>7 support. 

>* Do you want to continue? [Y/NJ: Y 
>ASN SY:=TK: 
>ASN NL:=^^: 
>MAC @Cl,124]SAVFWASM 
>SET /UIC=C1,24] 
>TKB eSAVBLD 
>TKB @BOOBLD 
>SEr /UIC=E1.24] 
>, 

>; DC^ 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 

>SEr /UIC=C200,200] 
>ASN = 
>@ <EOF> 
> 



A NEW COPY OF THE BOO AND- SAV TASK ARE NOW OST YOUR SYSTEM DEVICE. 
YOU MAY EXECUTE THE FOLLOWING COMMAND: 
>REr-l BOO 
>REM SAV 
>INS IBO:$SAV 
>INS LBO:$B0O 
>ACS SYO:/BLKS=0 
>SAV 

USE @[1, 1243CREATEfrmJ.CMD OR (§[1 .124jCREATEFLP.CMD TO CREATE SYSTEMS 
CN THE WINCHESTER OR FLOPPY DEVICES. 
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E. SYSGEt^ OONSIDERATICNS 

If the target system's RSXllM files differ frcm those of the host system, the 
corrplete Sysgen procedure mast be followed . Since this procedure changes from 
release to release, an atteirpt here to recap the steps outlined in the Sysgen 
manual would be pointless. The folloving notes may, however, be^ helpful: 

1) It is possible to perform a SYSGEN specifying all drivers to be loadable. In 
this case, one can answer affirmatively to build many of the DEC-supplied 
drivers. SYSGEN will create tables for each driver specified (in the SYSTB.MAC 
output file). This may be desirable ejcpecially if a number of drivers are 
potentially needed one at a time. However, the Executive space consumed by such 
a list of tables becomes quite large. 

One can remedy this situation by editing the SYSTB file and saving the generated 
tables, then unlinking them frcm the list to be task built with the Executive, 
leaving only the pseudo devices and possibly "TT; " in SYSTB. MAC. Then the saved 
table file may be broken down into individual table files and used as described 
in the Guide to Writing an I/O Driver (see FViTTAE.MAC as an exanple of such a 
table file). Following this, the DRVBLD indirect ccanmand control file can 
include the table files ' in the resultant driver task build operations v\ftiich take 
place during Sysgen Phase Two. 

This procedure was used by DEC for the creation of the RSX-llM baseline 
distribution systanis. It is likely that future releases of RSX-llM will include 
the table files as separate sources so that tliis inconvenient procedure can be 
avoided. 

2) Pool space is allocated permanently by the MCR or VMR IDA commands for 
drivers ^lich have a table segment and whose names do not already exist in the 
device tables. This is because the tables must always be addressable to the 
Executive (in the lowest physical 16K of a mapped system). If the default pool 
space value suggested ty SYSGEtJ is used, the result will be an inadequate amount 
of pool space left after drivers are loaded. Once a systen is SAVed, the 
partition containing SAV.TSK cannot be re-allocated, so be sure to have an 
adequate amount of pool space before SAVing the target system. A ballpark figure 
would be 1000(10) bytes plus 120(10) bytes for each terminal/ task caribination to 
be concurrently operating after INStalling all tasks desired at boot time and 
lOAding all drivers required at boot time plus those required concurrently 
without re-booting. 

3) The FW driver does not require the $BLKCK subroutine or the $GIWRD or $PIVy/RD 
subroutines. The default vector address is under 400(8). Therefore, the user 
written driver question does not have to be answered positively. However, if 
some driver requiring one of these routines is desired at a later time, it cannot 
be LOAded unless all referenced routines are present in the Executive. The 
Sysgen program asks the user about the $G'IV7RD and $PTWRD routines, but not about 
the $BLKCK routine. Therefore, we suggest that the user locate tliis routine to 
be defined only if certain DEC drivers are specified in the original Sysgen Phase 
1. That is, make the routine ejcpand always if it is expected that any driver 
will be added to the system at some later time. 

4) The IMLoad command does not remove tlie tables corresponding to a driver that 
is unloaded, even if the driver task contains internal table definitions. 
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Therefore, never save a system with drivers leaded when it is intended that 
alternative driver/ table tasks (as with the baseline systons) will be used unless 
you have copied the system image with PIP before doing so. Once a system is 
saved with a driver table, the table is there to stay. 

5) Vifhen a nev Sysgen is performed, execute the nonnal Sysgen Phase I and Sysgen 
Phase II. Save and boot will be built during Phase II. At the end of Sysgen 
Phase II, but before booting your ne^v system, you must rebuild the FW driver and 
the FW utility. See Section III.D. 
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III. COMPLETE RSXllM DISTRIBUTIOsT - FLOPPY DISK 

If your distribution consisted of one RX02 floppy and not the complete RSXllM 
syston, then see section II. 

Digital Equipnient Corporation requires a software license for each corrputer that 
contains a RSXllM system. See your local SMS or DEC representive for additional 
information. 

A. DISKETTE DISTRIBUTION 

If your distribution is on cartridge tape process to section IV. 

The conplete RSXllM distribution from SMS consists of the following double sided 
IBM formatted floppy diskettes- 

LABEL 

1. "BOOTABLE" 

2. "BOOTABLE GCNTINUATION" 

3. "SYSGEN (1 OF 4) 

4. "SYSGEN" (2 OF 4) 

5. "SYSGEN" (3 OF 4) 

6. "SYSGEN" (4 OF 4) 

7. "HELP" 

8. "ERRORLOG" 

9. "SYSGEN PHASE III" (1 OF 2) 

10. "SYSGEN PHASE III" (2 OF 2) 

11. "MCR SOURCES" (1 OF 4) 

12. "MCR SOURCES" (2 OF 4) 

13. "MCR SOURCES" (3 OF 4) 

14. "MCR SOURCES" (4 OF 4) 

15. "RMS-11" (1 OF 2) 

16. "RMS-11" (2 OF 2) 



DESCRIPTION 

MINIMAL RSX-llM BOOTABLE MAPPED SYSTEM 
LIBRARIES, TKB, MAC, EDI, FWDRV.MAC,ETC. 
[1,20] 

[1,24], [200,200] 

[11/10] 

[11,10] 

■HELP FILE[1,2] 
ERRL0G[1, 6], [104,10] 
[1,20]*.OLB 

[1,20]*.BLD, [2,300], [1,51] 

[12,10] 

[12,10] 

[12, 10], [12, 24], [14, 10], [11, 10] 
[23, 10], DCL, [45,10] 
•Rt>IS-ll [1,1], [1,20], [1,24] 
RMS-11 [1,54] 



III - 
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B. INSTALLATION OF RSXllM DISTRIBUTION 

Insert the bootable floppy into floppy unit and hit the reset button. The 
follcwing installation dialogue will take place: (if system does not boot, see 
section II I. E for possible solutions). Ciperator responses are underlined. 

DRV? 
PO 



RSX-llM V4.0 BL32 128K MAPPED 
>RED FW:=SY: 
>RED BW:=LB: 
>MOU FLOPPY 
>(§FW:Cl,2]STARTUP 

>* PLEASE ENTER TIME AND DATE (PIR:MN DD-MMM-YY) [S]: 15HMAR-83 
>TIM 15-MAR-83 
>SET /UIC=C1,124J 



*D0 YOU V2ANT TO COPY RSXllM DISTRIBUTIOsf TO WINCHESTER DISK? CY/N]:Y 
YOU MUST NaV ENTER THE TYPE OF WINCHESTER DISK THAT IS ON YOUR SYSTEM. 
THE FOLLOWING WINCHESTER DISK TYPES ARE SUPPORTED: 



> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 
> 

>* ENTER THE OODE FOR THE WINCHESTER DISK [D R:l.-20. D:13.]: 13 
>FWU FW2:/SIZE=34700/HD=4/ST=17/CY=512 

>* YOU ARE ABOUT TO INITIALIZE THE WINCHESTER DISK - CONTINUE? [Y/N]:Y 
>; 

>SET /UIC=C1,54] 
>ALL FW2: 
>FWU EW2:/VE 

FW2: /Verify — continue? (Y/N): Y 
CaSTTINUOUS VERIFY? (Y/N): N 
** Begin Verification ** 
>BAD EW2: 

BAD — EW2: TOTAL BAD BLOCKS= 0. 

>INI FW2 :WINCHESTER/BAD=CAUTO]/MXF=1500/LRU=5/INF=314 . 
>* DID THE WINCHESTER DISK INITIALIZE CORRECTLY? CY/N]:Y 
>MOU FW2:/0VR 
>UFD EW2:C1,1] 



OODE 


TYPE 


DESCRIPTION 


1 


ST406 


(SEAGATE 5 1/4-JNCB, 5.5 MEGA BYTE) 


2 


ST412 


(SEAGATE 5 1/4-INCH, 10.6 MEGA BYTE) 


3 


Sr419 


(SEAGATE 5 1/4-INCH, 15.4 MEGA BYTE) 


4 


RO204 


(RODIME 5 1/4-n^CH, 21.8 t^EGA BYTE) 


5 


R0206 


(RODIME 5 1/4-INCH, 32.6 MEGA BYTE) 


6 


RO208 


(RODIME 5 1/4-INCH, 43.5 MEGA BYTE) 


10 


SA1002 


(SHUGART 8-INCH, 4.5 MEGA BYTE) 


11 


SA1004 


(SHUGART 8-INCH, 8.9 MEGA BYTE) 


12 


Q2010 


(QUANTUM 8-INCH, 8.9 MEGA BYTE) 


13 


Q2020 


(QUANTUM 8-INCH, 17.8 MEGA BYTE) 


14 


Q2030 


(QUANTUM 8-INCH, 26.7 MEGA BYTE) 


15 


Q2040 


(QUANTUM 8-INCH, 35.6 MEGA BYTE) 


16 


Q2080 


(QUANTUM 8-INCH, 71.2 MEGA BYTE) 


20 


SA4008 


(SHUGART 14-INCH, 26 MEGA BYTE) 
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>UFD BW2:[1,2J 
>UFD FV72:[1,3J 
>UFD FVV2:[1,4] 
>SET /UIC=[200,200] 
>UFD FW2:[1,6] 
>SET /UIC=[1,54] 
>UFD BW2:Cl,7] 
>UFD FW2:[1,20] 
>UFD BVJ2:[1,24] 
>UFD FW2:C1,30] 
>UFD EW2:[t,34] 
>UFD FW2:C1,50] 
>UFD FW2:[1,51] 
>UFD FW2:Cl,54] 
>UFD t"W2: [200,200] 
>UFD FW2:C2,300] 
>UFD FW2: [11,10] 
>UFD FW2: [11,20] 
>UFD BV72:[11,24] 
>UFD FW2: [11,30] 
>UFD FW2: [11,34] 
>UFD FW2: [12,20] 
>UFD RV2:[12,24] 
>UFD FW2: [1,124] 
>UFD BW2:[1,120] 

>PIP FW2:[*,*]/PO=SY0:[*,*]*,*/P0 
>PIP FW2:[0,0]=SYO:[0,0]RSX11.SYS 
>PIP FW2:[1,54]RSX11M.SYS;*/DE 

>PIP BV72 : [1 , 54]RSX1 IM . SYS/CO/BL : 182 . =FW2 : [1 , 54]RSX1 IM .TSK 

>ASN PW2:=SY0: 

>ASN FW2:=LB0: 

>INS $:VMR 

>VMR @[1,124]RSX 

VMR ~ *DIAG* — INSTALLED TASKS MAY NO LONGER FIT IN PARTITION 
SET /TOP=DRVPAR:-* 
POOD=1000:4610. :04610. 

>;THE WINCHESTER DISK IS NOW READY TO BOOT. 

>;THIS COMMAND FILE WILL BOOT THE NEW SYSTEM. WHM IT DOES mTER THE 
>;F0LLC^7ING COMMANDS: (YOUR RESPONSES ARE UNDERLINED) 



>; 

>; XDT 26 

>; XDT>G 

> ; - 

>; DEVICES NOT IN OWIGURATICN 

>; (ENTER A CARRIAGE RETURN) 

>; >TIM 15-MAR-83 

> . 

>; >m[J R'J2:/SIZE=34700/HD=€/S']>=17/CY=512 

> . , . , . „, : 

>; >SAV /m 

> . ^. 

>; (YOUR NEW RSXIBI SYSTEM WILL BOOT AUTCHATICALLY) 

>; >AtJSlAER YES TO THE QUESTIOST "DO YOU WANT TO OCNTINUE THE 

> ; >INSTALLATiasr? " 
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>; 

>* DO WANT TO CONTINUE? [Y/Nj :Y 

>B00 

XDT: 32 

XDT>G 

RSX-llM V4.0 BL32 
> TIM 15-MAR-83 

>FWU EW2;/SIZE=37400/HD=4/ST=17/CY=512 
>SAV /WB 



RSX-llM V4.0 BL32 128K MAPPED 
>RED PW2:=SY: 
>PED FW2:=LB: 
>MOU FW2:WINCHESTER 
>@PW2:[l,2]STARrUP 

>* PLEASE HSfTER TIME AND D?VrE (HR:MN DD-MTIM-YY) [Sj: 15-MAR-83 
>TIM 15Hy!AR-83 
>SET /UIC=[1,124] 

>* DO TO WANT TO CONTINUE THE INSTALLATION OF RSXllM? CY/N]:Y 
>ALL FWO: 

>INSERT FLOPPY lABELED "BOOTABLE CONTINUATION, HIT <CR>?[Y/N]: 
>MOU FW0:/OVR 

>PIP EW2 : [* , * J/UF/P0/NM/NV=FW07 [*,*]*. */PO/NM 
>; 

>;A COMPLETE RSX-llM SYSTEM NOW RESIDES ON 

>;THE WINCHESTER DISK. IF YOU DO NOT DESIRE TO PERFORM 

>;A SYSGEN IHBST THE INSTALLATION IS COMPLETE. 

>;AT A LATER DATE YOU MAY INSTALL OTHER FLOPPIES 

>;FROM THE DISTRIBUTION BY TYPING @[ 1,124] INSDIS. 

>• 

>;D0 YOU WISH TO QUIT NOW?[Y/Nj:Y 
>DMO FWO: 

DM0 — TTO: DISMOUNTED FROM BWO: ***FINAL DISMOUNT INITIATED*** 
*** FWO: — DISMOUNT COMPLETE 

> @<EOF> 
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C. SYSTEM GENERATICN 

Refer to the RSXllM system generation manual for details concerning system 
generation. Sysgen Phase I and Phase II proceed without deviation from the 
Sysgen itanual. At the end of Phase II, but before you boot your n&rj system you 
mst execute the follcwing command file. Your responses are underlined: 

>;END OF SYSGEN PHASE II 

>@<EOF> 

@[200,200]FWGEN 
>;THIS COMMAND PERFORMS TEiE FOLLOWING FUNCTI(3SrS: 
>; 1-ALLOW YOU TO EDIT THE FW (XNITIONAL FILE "PREFW.MAC" 

>; 2-ASSEMBLE AND TASK BUILD THE "FW" DRIVER 

>; 3-ASSEMBLE AND TASK BUILD THE FW UTILITY "FWU.TSK" 

>; 4-RUN Vm TO INSTALL NEW "FW "DRIVER AND "mj" UTILITY 

>* DO YOU WANT TO OCNTINUE? [Y/N]:Y 
>; 
>; 

>* ARE YDU BUILDING m FOR A MAPPED SYSTEM? [Y/N] :Y 
>SET /UIC=[1,54] 

>;THE FOLLOWING FILES MUST BE PRESENT CN YOUR SYSTEM DISK BEFORE WE CAN 
>; PROCEED. 

>; 

>; 1- Cll,10]RSXMC.MAC (YOUR SYSTEM OCMDITIONAL ASSEMBLE FILE) 

>; 2- [1,1]EXEMC.MLB (EXEC MACRO LIBRARY) 

>; 3- C1,1]RSXMAC.SML (SYSTEM MACRO LIBRARY) 

>; 4- [1,1]EXELIB.0IB (EXEC LIBRARY) 

>; 5- [1,1]SYSLIB.0LB (SYSTEM LIBRARY) 

>; 6- [1,5X]RSX11M.STB (MAPPED OR UNMAPPED SYMBOL TABLE) 

>; 7- [1,2X]SAV.0LB,B00.0IB,MCR.0LB 

>; 

>;ESPECIALLY MAKE SURE THAT THE PROPER RSXMC.MAC IS IN [11,10] 

>; 

>* ARE ALL THE ABOVE FILES PRESENT IN THE PROPER UIC? [Y/N]:Y 
>* DO YOU WANT TO EDIT THE EW CONDITIONAL ASSEMBLY FILE? [Y/^]:Y 

>; 

>;IT MAY BE NECCESARY TO EDIT THE EW DRIVER HJILD FILE TO CHANGE THE 
>;PARITICN NAME. 

>* DO YDU WANT TO EDIT 1HE BUILD FILE FOR THE FW DRIVER? CY/N]:N 

>MAC [1,124]FWDRV=[11,103RSXMC/PA:1,C1,1]EXEMC/ML,[1,124]PREEW,FWDRV 
>MAC Cl,124]FWTAB=[ll,10]RSXMC/PA:l,Cl,l]EXEMC/ML,[l,124]PREFW,EWrAB 
>TKB @L1,124]FM)RVBLD.CMD 
>7 

>;IT MAY BE NECCESARY TO EDIT THE EW UTILITY BUILD FILE TO CHANGE THE 
>;PARITICN NAME. 

>* DO YDU WANT TO EDIT THE BUILD FILE FOR THE E\^ UTILITY? [Y/N]:N 

>MAC [1,124]FWU=C1,1]EXEMC/ML, [1,124]FWU,PREFW 

>TKB (aCl,124]EWUELD 

>TIM 

00:10:57 15-MAR-83 
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>; 

> ; YOU mLL NCW HAVE A CHANCE TO RUN VMR TO LQA THE lOTW DRIVER AND 
>; INSTALL THE NEW COPY OF THE UTILITY PROGRAM. EXECUTE THE FOLLOWING 
>;GO!yiMANDS WHEN YOU ARE PROMPTED BY VMR: 



>7 






>; 


BSfTER FILECqAME:RSXllM 


(OR @[ 1,1 243RSX.CMD IF APPROPRIATE) 


>; 
>; 


\MR>LOA FW:/PAR==GEN 


(OR THE APPROPRIATE PARTITION) 


>; 
>; 


VMR>INS ™ 




>; 
>; 


VMR> (CONiTROL Z) 




>; 

>VMR 






ENTER 


FILENAME: RSXllM 





VMR> LQA 

vmr> ins EMJ 

VMR> Z 
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D. SYSTEM DOES NOT BOOT 

If the RSXllM flcppy does not boot, inseirt the FW installation floppy and atterrpt 
to boot it. Refer to FW Installation and Test Manual for instructions on running 
the tests. If the installation flcppy boots then the following conditions may 
have caused RSXllM not to boot: 



Bad media. 

Not enough memory in system. (124KB minimum) 

Memory strapped incorrectly. , 

Flcppy disk unit not double sided. 

Real time clock turned off. 

Strappings on LSI-11/23 not correct. 

Vector or control status register address conflict. 
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IV. COMPLKTE RSXllM DISTRIBUTION - CARTRIDGE TAPE 

The cartridge tape distribution consists of two RSX-llM tapes plus one FW 
Installation and Test tape: 

(Tape 1) - Corrplete RSX-llM Distribution. (Tape 2) - BRU Tape with MCR 
sources and RMS-11. (Tape 3) - Bootable FW Installation and Test. 

A. Installation of RSX-llM from tape. 

1. Inseirt and boot installation and test tape. 

DRV(PO,WO,T)? T 

2. Select command: L 
Select Winchester: WO 
Select Device: TO 

3. The load process takes 15 rninutes. 

B. RSX-llM distribution on tape is set up with multiple logical 
volumes enables. 

The sane tape distribution is used for 20,40, or 80 megabyte 
disks. FW2: is the first 20Mb, FW3: is the second 20Mb, FW4: 
is the third 2QMb, and F\t^5: is the last 20Mb. 
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V. BW DISK UTILITY (FWU) 



The FW Disk Utility (FWU) provides the capability for users to 
dynamically redefine media formats on a per unit basis and, in 
addition, implements certain general purpose utility functions 
not available with DEC-supplied software. FV/U can be permanently 
installed into an PiSX-llM system as an MCR function or may be 
invoked by using the ^K!R RUN ccmmand in the manner described in the 
PSX-11 Utilities Procedures Reference Manual. 



A. FWU COMMAND ENTRY 

FWU functions are requested ty entering command strings through 
the initiating termini. Conmand strings consist of an optional 
device specifier followed ty one or more optional switches and 
subswitcihes follov^ed by an optional comment. The general form of 
a conmand is: 

[dduu:] C/sw] [/sw=valj [...] [;commentJ 

v^ere: [ ] (square brackets) indicate optional entry. 

dduu is a PHYSICAL device name eg., "FV7" or "DK3". 

No logical device names can be used with FWU. 

sw is a switch. Some switches require an argument, 

others do not. 

val is a string following a switch v*iich requires 
an argument. If a numeric argument is needed, 
val is interpreted as a decimal number. 

comment is any string following the occurance of a 
sonicolon ( ; ) and is ignored ty the command 
string interpreter. 

A function specification consists of a slash (/) followed ty a variable length 
switch mnemonic. The switch may be followed ty an argument separated from the 
switch ty an equal sign (=) . Note that no equal sign is used in the string to 
separate input and output sides of a ccmmand. Instead, each function has an 
iitplied irput or output condition. This is similar to one-sided PIP commands 
such as /DE. Note also that any number of switches may be combined on a single 
ccmmand line as long as they all represent operations to be performed on a single 
device. 
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B. FVJU FUNCriCN SUMMAIOT 

Based on the cx>ntext of the cxarmand line, a switch is either a main switch or a 
subswitch modifying a min sitch. Sydtches are parsed by the F^CF conmand string 
interpreter sequentially, but are acted upon according to a hierarchy v^ich the 
program considers to be appropriate. This allows flexibility vih^n entering 
ccmmands While insuring that the indicated operations do not destructively 
interfere with each other. 

Table V-1 lists the conmand switches according to the hierarchy, from highest 
(first executed) to lowest: 

Table IV. A 
Conmand Switches and Subswitches 

/HE[LP] Print conmand summary on initiating terminal and ignore ranainder 

of conmand line. This switch must be first on the command line, 
if entered, and mast not follow a device specification. All 
other conmand input lines must contain a device specification and 
cannot have this switch present. 



/RXOl 


Set 


flcppy 


disk 


unit 


to 


RXOl format. 




/RX02 


Set 


flcppy 


disk 


unit 


to 


RX02 format. 




/RX03 


Set 


flcppy 


disk 


unit 


to 


PX03 format. 


(Double sided) 


/IBMO 


Set 


flcppy 


disk 


unit 


to 


single side. 


single density IBM format. 


/IBMl 


Set 


flcppy 


disk 


unit 


to 


double side. 


single density IBM format. 


/IBM2 


Set 


flcppy 


disk 


unit 


to 


single side. 


double density IBM format. 


/IBM3 


Set 


flcppy 


disk 


unit 


to 


double side. 


double density IBM format. 










NOTE: 






4' 



The RXOn switches and the /IBMn switches are mutually exclusive. 

/IL=n Set interleave policy for floppy units. The value of n must be 

0, 1, or 2. -> no offset or interleave; 2 -> both offset and 
interleave. This switch may be used as a subswitch of the /RX or 
/IBM main switches to override tlie value assumed when either of 
the latter is specified. 

/SL=n Set sector length for IBM flcppy or Winchester units. This is a 

main switch for Winchester units and a subswitch modifying the 
/IBM main switch for flcppy units. Legal values for n are listed 
in Table V-2. 

/HD=h Set number of heads/drive for Winchester unit. 

/ST=n Set nuniber of sectors/track for Winchester unit. 
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Set physical unit for VJinchester device. 

Set logical block offset for floppy or Winchester units. This is 
a subswitch of the /IBM or /RX main switch if the specified unit 
is a floppy disk, and a main switch if the specified unit is a 
Winchester . 



NOTE: 

The /ED, /ST, /SL, and /SIZE switches, with possible modifying 
/OF and /UN switches, fom a corplete specification of control 
information needed for proper operation of the Winchester. 

The /IBMn switch, in conjunction with possible /OF, /SL, and /IL 
si±witches, form a ccrrplete specification of an IBM format floppy 
unit. 

The /RXOn switch, in conjunction with possible /OF, /IL 
subswitches form a conplete specification of an RXOl or RX02 
format floppy unit. 

Set device size in blocks for any FILES-11 device unit on the 
system. The value of n entered is assumed to be a decimal 
number. This switch may be used as a subswitch of the /RX or 
/IBM main switch to overide the value assumed vhen either of the 
latter is specified. 

Set any device unit logically online (n=l) or logically offline 
(n=0) . 

Set any device unit software write-protected (n=l) or software 
write-enabled (n=0). 

Set device mnemonic for any device on the system. The value of 
dd mast be tWD alpha characters. 

Display device information. The information displayed varies 
according to the device specified in the command. 

Format diskette loaded in flcppy disk unit. 

Verify readability of entire device surface. May be used as a 
subswitch of the /FO command or as a min switch for any device 
on the system. 

Copy entire device surface. Following the entry of the device 
name (to be copied), an interactive dialogue is invoked to 
specijfy the copy output device and other copy parameters. 
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C. FWU FLOPPY DISK FUNCTIOSIS 

Scrne FV/U cxmmands are ^prcpriate only for floppy disk units. The operation of 
these is detailed in this section. 



/RXOl, /PX02, and /RX03 — Specify DEC-corpatible diskette forrrat 

The entry of the /RX01,/RX02, and KX03 switch specifies that subsequent 
read/write/ format operations on the referenced drive should assume a 
DEC-conpatible diskette formt. The entered switcih sets the device size, 
interleave and track offset policy, sector length, density, heads /cylinder, and 
sectors/track control fields Which the driver uses v^en performing I/O operations 
(see Table IV.B). The device specifier must refer to an unmounted flcppy disk 
unit. 

These switches may be modified by the /IL subswitch to override the default 
interleaving policy or ty the /OF subswitch to provide a logical block offset 
v^en performing I/O operations. For most applications, neither of these 
modifiers should be used. 



/IBMO, /IBMl, /IBM2, and /IBM3 ■— Specify IBM diskette format 

The entry of any of the /IBM switches specifies that subsequent read/write/ format 
operations on the referenced drive should assume an IBM-caipatible diskette 
format. The entered switch sets the device interleave and offset policy, sector 
length, density, heads/cylinder, and sectors/ track control fields vhich the 
driver uses v^en performing I/O operations (see Table VI.B). The device 
specifier must refer to an unmounted floppy disk unit. 

These switches may be modified ty the /IL subswitch to override the default 
interleaving policy, by the /OF subswitch to provide a logical block offset vhen 
performing I/O operations, or ty the SL switcli to override the assumed sector 
length of 512 bytes. 

For FILES-11 operation, the 1024-byte sector length is illegal since I/O 
operations must begin on a block boundary. This makes the 512-byte sector length 
the most efficient (highest overall data transfer rate because there is more data 
space relative to control and gap space). Also, the default interleaving policy 
of no interleaving, 1/4 track offset is the mDst efficient (least wait incurred 
by the head crossing a cylinder boundary during a transfer) . 

/OF=n — Specify Block Offset for Flcppy Unit (subswitch) 

This subswitch specifies that subsequent Logical Block read and write operations 
should be performed ty adding the number "n" to the starting block before 
initiating the operation. This feature could be used v^en it is desired to make 
a number of sectors inaccessible to standard FILES-11 I/O. FMJ adjusts the 
device size calculated in the /IBM or /PX rrain switch downward by the /OF 
argument (n) . This feature is not to be confused with reserving Track of 
floppy units (which is automatically done by the controller \f\hen performing 
Logical Block I/O) . 
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For most applications, this feature is not useful. Hcwever, the specification of 
/0F=1 enables the FW driver to read and write FILES-11 volumes created by the 
driver supplied with SMS's FT series of controllers. The FT and 512-b7te FW 
media fomiats are identical, but the FT driver reserves the first block of 
storage for firrrware bootstrap code. 

/llr=n — Set Interleave Policy for Floppy Unit 

This switch is used to control the sector interleave policy and the track offset 
calculation to be performed for logical block read/write operations. The /IBM 
and /RX switches establish a default value for the interleaving control field 
v*^en entered. The /IL switch must be subsequently used if the default is to be 
overridden. See TalDle IV. A for legal values of n. The device specifier must 
refer to an unmounted floppy disk unit. 

As ejcplained earlier, overriding the default interleaving for RXOl or RX02 
diskette formats inproves the performance but makes the media incarpatible with 
the DX or DY driver (see Programming Considerations section). Changing the 
default interleaving for IBM formatted floppies is not useful in most 
applications. For a more thorough discussion of interleaving policies, see the 
FWDOlOO/FWDllOO OEM Manual. 

/SL=n Specify Sector Length for Floppy Unit (subswitch) 

This subswitc±i is used to set the sector length to be assumed ty the FW driver 
for subsequent read/write/ format operations on the referenced drive. The device 
specifier must refer to an unmounted IBM format floppy disk unit. 

Execution of this subswitch sets the sector length control field and the device 
size. The value of "n" affects the device size due to the fact that there is a 
variable number of sectors per track depending on the sector size selected (see 
Table IV. B). 



/PO — Format Floppy Diskette 

This function if used to initialize tlie control and data fields of a diskette. A 
diskette may be formatted in an/ of the DEC or IBM formats discussed above. Only 
the density and sector length fields are required in order to format a diskette. 
The interleaving, track offset, etc., pertain to reading and writing the diskette 
once it is formatted. 

Diskettes vhich have been formatted may be reformatted at any time. This is 
called "soft sectoring". When the format operation is invoked,* the user is 
queried as to v*ien and whether to initiate the format operation as a safeguard 
against destroying diskette data. The device specifier must refer to an 
unmounted floppy disk unit. 

The /VE (verify surface) switch should generally be used in conjunction with the 
/FO switch. FWU is sensitive to this combination and initiates the verify 
immediately following the formatting if the two command switches are entered on 
the same line. 
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The follcwing table lists device information corresponding to the pDssible 
combinations of FWU flcppy disk switches: 

Table IV. B 
FW Flcppy Disk Parameters 



Format 


/SL n Value 


Sec/Trk 


Sides 


Device Size 


/IBMO 


128 or 


26 


1 


494 


/IBMO 


256 or 1 


15 


1 


570 


/IBMO 


512 or 2 


8 


1 


608 


/IBMO 


1024 or 3 


4 


1 


608 


/IBMl 


128 or 


26 


2 


988 


/IBMl 


256 or 1 


15 


2 


1140 


/IBMl 


512 or 2 


8 


2 


1216 


/IBMl 


1024 or 3 


4 


2 


1216 


/IBM2 


128 or 


44 


1 


836 


/IBM2 


256 or 1 


26 


1 


988 


/IBM2 


512 or 2 


16 


1 


1216 


/IBM2 


1024 or 3 


8 


1 


1216 


/IBM3 


128 or 


44 


2 


1672 


/IBM3 


256 or 1 


26 


2 


1976 


/IBM3 


512 or 2 


16 


2 


2432 


/IBM3 


1024 or 3 


8 


2 


2432 


/RXOl 


(128) 


26 


1 


494 


/RX02 


(256) 


26 


1 


988 


/RX03 


(256) 


26 


2 


1976 



IV - 27 



3000669/D 



D. BMJ WINCHESTER DISK FUNCTICNS 

Some FWU comnmands are appropriate only for Winchester disk units. The operation 
of these is detailed in this section. Floppy disk hardware formats are currently 
well defined, thus the FWU floppy disk switches were designed to perform very 
formalized functions. However, to provide maximum flexibility for various 
Winchester drive formats (present and future), PWU Winchester-specific switches 
allow independent settings for each device parameter used ty tlie FW driver. 
Since not as much error c±iecking can be built into the FWU utility under these 
guidelines, the user must be responsible for insuring that the control parameter 
set by these switches agree witli the hardware characteristics of the actual drive 
being used. 

/HD=n — Specify Number of Heads for Winchester Disk 

This switch is used to set the number of heads for the specified device. The 
value of "n" is used only for the Physical Block I/O operations. The controller 
handles the block number to cylinder/head/sector conversion for Logical Block I/O 
operations. The device specifier must reference an unmounted VJinchester unit. 



/ST=n — Secify Number of Sectors/Track for Winchester Disk 

This switch is used to set the number of sectors/ track for the specified 
Winchester unit. The value of "n" is used only for Physical Block I/O 
operations. The controller handles the block number to cylinder/head/ sector 
conversion for Logical Block I/O operations. The device specifier must reference 
an unmounted Winchester unit. 



/SL==n — Specify Sector Length for Winchester Disk 

This switch is used to set the sector length for the specified device. The 
device specifier must reference an unmounted Winchester unit. The value of "n" 
specified MUST agree with that of the actual drive being used. The controller 
accepts only tWD values; 256 and 512. On entry, 1 may be used to mean 256, and 2 
may be used to mean 512. 

/CY=4S[ — Specify Number of Cylinders/head for Winchester Disk 

This switch is used to set the number of cylinders/head for the specified 
VJinchester unit. The value of "n" is used only for Physical Block I/O 
operations. The controller handles the block number to cylinder/head/ sector 
conversion for Logical Block I/O operations. The device specifier must reference 
an unmounted VJinchester unit. 

/OF=n — Specify Block Offset for Winchester Disk 

This switch is used to set a block offset to be applied by the FW driver prior to 
initiating Logical Block I/O operations. The device specifier must reference an 
unmounted Winchester unit. 
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This switch has the effect of reserving disk space and rendering it inaccessible 
to FILES-11 operations. Thus for most applications, this feature is not useful. 
However, it is possible to use the /OF switch in conjunction with the /UN switch 
to break one Winchester drive into tv»ro logical device units (see exairple later in 
this section) . 

The desirability of using one surface as two logical units is dependent on the 
target application. Note that once the Winchester is INItialized to a single 
logical unit per drive, it is not possible to change the offset and retain 
usability of the surface without corrupting the data on it. 



/UN=n — Specify Physical Unit Number of Winchester Disk 

This switch sets the physical unit number of the referenced device. The value of 
n must be in the range (2-3). The device specifier must reference an unmounted 
Winchester unit. 

Seme Winchester drives do not have a unit select control line. It is therefore 
not possible to attach two such drives to a single controller. In other cases, 
the user has only one Vdnchester drive. If desired, this switch, in conjunction 
with the /OF switch, could be used to divide the surface of a single Winchester 
dirve into two separate logical devices. 

The follaving conmand sequence can be used to make a Q2040 function as two 
equally-sized units: 

>FWU FW2 :/HD=8/ST=17/SI^512/OF=0/SIZE=34700/UN=2 
>FWU FW3 : /HI>8/ST=17/SIr=512/OF=34700/SIZE=34700/UN=2 

In this case, PW2: beccmes tlie first (outermost) half of the surface and FW3: 
becanes the second (innermost) half of the surface. Care should be taken to 
insure that the addressing space does not overlap. If if does, the integrity of 
the file structure will not be insured. 
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The folloving table lists device information corresponding to the possible 
combinations of FWU Winchester disk switches. 



Table IV-C 





rm/ 1)1,' 


/ oX^fj 


/ HI-' 
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E. FWU GENERAL PURPOSE FUNCTICNS 

Several general purpose functions are provided for use with the device-specific 
functions alreadj^^ described. The operation of these is detailed in this section. 



/HE[LP] — Print Help Message 

This switch causes a oamrnand summary to be exhibited on the initiating terminal. 
The /HECLP] command should be the only string entered. No device specifier is 
allowed. Any remaining canmand text on the entry line is ignored. Only the most 
ccmmonly used functions are shewn. 

/SlCZE]=n — Specify Device Size 

This switch causes the single precision value of "n" to be set in the device 
table as the size (in 512-byte blocks) of the referenced unit. This is allcwed 
only for FILES-11 devices (v^ich contain this information in a standard 
location). The size of each unit of a controller is independent. This switch 
was designed to be used primarily for setting the size of Winchester units. Use 
with other devices in the system is not advised. 



/CN=n — Set Device Status Offline/Online 

This switch is used to set/reset the offline/online bit in the status of the 
referenced unit. The entry of "1" for n sets the bit to OSILINE; "0" for n sets 
the bit to OFFLINE. 

The Executive disallows atterrpted accesses to units v\hich have this bit set. The 
system startup task (SAV) initially fixes the offline/online status for all 
devices. Each CSR is examined and if not present, all units on the correspondng 
controller are set to offline. For same devices, each unit on an existing 
controller is individually tested by device-specific code. For the rerainder, 
this switch is available. 

For the FW driver, specifically, the "Device Not Ready" error code will probably 
be returned if an access is atterpted on a unit v^ich is physically not present 
unless the /aSF=n switch used, in v^ich case the Executive will return the "Device 
Offline" error code instead. We chose not to insert device-specific code into 
the SAV task (other than the bootstrap driver) so as not to alter DEC-supplied 
software. 



/WP=n — Set Device Software Write Protected/Enabled 

This switch set/resets the write-protect status bit for the referenced device. 
The Executive disallows write acceses to a unit if the status is set to 
protected. The entry of a value of for n sets the status to ENABLED. The 
entry of a value of 1 for n sets the status to PROTECTED. 

This switch is useful v^enever it is desired to use a volume in a read-only 
manner. A FILES-11 volume v\hich is write protected (either by software or 
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hardware) may be MOUnted and DisMOunted and otherwise used as long as no write is 
attenpted (Caution: INStall requires write access). 

/NA[ME]=dd — Specify Device Name 

This switch is used to change the PHYSICAL name of the referenced device. 
Because of the table structure of RSX-llM, it is not possible to change the name 
of a specific unit. This function alters the name of ALX. units on a controller. 
The value of "dd" must be twD alphabetic characters. 

No harmful effects are incurred to the operating system as the result of using 
this function since logical assignments, redirections, and the like are all done 
with address pointers (v\^ich the function does not change) . However, a task 
which has a file open v^^en the name is changed may suffer subsequent file syston 
errors \fh.en a re-open, close, or delete is attenpted. 

This switch was provided to be used with some DEC-supplied tasks (notably FLX) 
whicih have built-in device tables to correlate device names v;ith legal functions, 
device sizes, etc. For example, it is necessary to use the device name DX or DY 
v^en creating/accessing an RT-11 diskette using the FW driver with FLX. The 
device name DK may be used ■when reading a DEC diagnostic diskette (actually 
DOS-11 directoried) using the FVV driver with FLX. 

The user may determine that the device name FS7 should be permanently changed to 
DY. If this is the case, the system should be SAVed with the changed name. If, 
however, the driver is ever to be UNLoaded, the name must be changed back in 
order for UNLoad to function properly. 



/DI — Display Device Information 

This switch causes a series of informational lines to be exhibited on the 
initiating terminal. The information displayed varies according to the device 
referenced. The most information is displayed for floppy units, the least for 
non-FW units. Basically, any parameter that can be affected by tlie FVJU utility 
is displayed. All of the numeric output is in decimal. If seme I/O operation is 
causing consistent failures, it is a good idea to use the /DI command as a 
diagnostic tool for examining the characteristics of the unit in question. 



/VE — Verifiy Readability of Entire Device Surface 

This switch may be used on any device unit in the system which may be read (eg., 
not the line printer) to perform a block by block scan of the device. Unlike the 
VFY utility, this function reads all of the blocks, not just the ones that are 
used in the file structure. It may be applied to mounted or unmounted volumes. 
The referenced unit need not be a FILES-11 device, nor need it be a block 
structured device. 

Once initiated, the verify routine will attempt to read the volume sequentially 
in (potentially) large data blocks. If a large block read failure occurs, a 
message will be printed indicating the block vs^ich the read started with. The 
function will then re-read the series of blocks one block at a time, reporting 



IV - 32 



3000669/D 



eacii and every logical block in Which an error, occurs. If the small block reads 
are all successful, read failure my be interpreted to be a "soft" error (the 
function performs large block reads vd.th retries inhibited). 

If the /VE switch is used in conjunction with the /PO switch, the verify 
operation will proceed immediately following the ccxnpletion of the formatting. 
Otherwise, the user will be asked to make the irput volume ready before 
attetipting to initiate the veri:fy operation. 

/CD — Copy Device Surface 

This switch invokes an interactive dialogue v^iich can initiate the copying of (a) 
volume(s) to (an) other volume(s). The actual execution of the function is 
dependent on the relative size of the two device units. If the irput device unit 
is large (with respect to the output device unit), the copy is assumed to be a 
volume backup. If the output device unit is large (with respect to the input 
device unit), the function is assumed to be a volume restoration. If the device 
unit sizes are equal, the operation is assumed to be a block-for-block copy 
operation. No file structure is involved, and neither of the device units may be 
Mounted at the time the copy function is initiated. For tape units, the device 
size is assumed to be infinite, thus a disk-to-tape is a backup and a 
tape-to-disk is a restore. 

This function does not perform any device-specific operations (such as revind). 
The user is responsible for having input or output non-file structured volumes at 
the ^5propriate locations before a copy is started. If an unequal size condition 
exists, the function prarpts for volume name and sequence numbers in a manner 
similar to PRESRV. There is an option (question answered by the user) to perform 
on-line verification of the copy. If answered affirmatively, the output volume 
must be block structured. 

The actual copy is performed using large block I/O. If the online verification 
is used, each block is 4K bytes long. Otherwise, each block is 8K bytes long. 
If the cperation performed is a restoration, the input volume name (created ty 
the corresponding backup operation) must be known. If not knew, the EMP utility 
may be used (device not mounted) to read the volume name vhich is in Block of 
the relatively small volume (DMP TI:=dduu:/BL:0:0/AS command). The volume name 
should stand out, as it is the only ASCII information in the block. 

Once the copy operation is started, errors are reported in a similar manner to 
that described in the /VE operation. Each long block is read. If not 
successful, the read is broken into small blocks and each small block is read 
with retry. The assoribled long block is written to the ouput device. If the 
online verify is not in effect, the sequence repeats. If verify is in effect, 
the output data just written is read back. The re-read block is compared with 
the original block still in memory WDrd for word. The sequence is then repeated. 

If an error is encountered during any part of the sequence, the user may elect to 
retry, continue, or abort the copy operation. If the error occurred during a 
long block read, the retry attempts the long read again; the continue performs 
the small block re-read to assemble a long output block and prints specific block 
number error message lines. If the error occurred during a write cperation, the 
retry attenpts to write the long block again; the continue skips to the next long 
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irput block. If the error occurred during a verify (read-back after write) the 
retry attenpts both the write operation and the verify again; the continue skips 
to the next long input block. If the error occurs during a data corpare, the 
hardware (memory, controller, or drive) is suspect unless the ccsipare follcws a 
write or read-back error. This error indicates that data read back from the 
output device does not matc±i that saved in memory from the input device. 

NOTE: The ccrnmnand interpreter built into FWU is table driven. It may be 
desirable for some users to limit the capabilities of the program by creating a 
version having only a subset of the provided switches (such as /IBM, /FX, /FO, 
/VE, /CD, and /DI). If so, the remaining switches may be elimnated ty removing 
the table entries for thon. The function dispatch table (FUNTBL) is located 
tcward the beginning of the source. 
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F. FWU UTILITY EXAMPLES 



The following examples illustrate FWU usage: 
>I 

>! Exairple 1: Help, Display, and Format 

>i 

>FWU iRUN INSTALLED VERSICN OF FWU 

FWU Disk Utility VI. 
For Help, Type /HE<CR> 

FWU>/HE , ;LIST HELPFUL INFORMATICN 

(Information is Displayed) 
FWU>FW1:/IBM2/DI ;SET DBLE ENSTY, 1 SIDE, 512-BYTE F^f^ 

(Device Information is Displayed) 

FWU>IW1:/P0/VE ;FORMAT FWl: AS IBM DD, 512 BYTE 

FWl: /Format — Continue (Y/tJ): Y 
** Begin Formatting ** 
** Begin Verification ** 

FWU>'^Z (Exit to MCR) 

>RUN $FWU IRUN UNINSTALLED COPY OF FMl 

FWU Disk Utility VI. 
For Help, Type /HE<CR> 

FWU>FW1:/IBM2/P0/VE ;aSIE-STEP FORMAT COMMAND ENTRY 

FV71: /Format — Continue (Y/N): Y 
** Begin Formattig ** 
** Begin Verification ** 

FWU>'^Z (Exit to MCR) 

> 
> 

>i Initialize Files-11 Volume 

>i 

>BAD mi: IMARK BAD BLOCKS 

>INI FW1:TEST ilNIT VOLUME 

>MOU PW1:/0VR 'MOUNT FILE-11 VOLUME 

>PIP FW1:/FR 'LIST STORAGE USAGE 

FV71: HAS 1188. BLOCKS FREE, 28. USED OUT OF 1216. BLOCKS 
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>DMD FWl: 'DISMOUNT VOLUME 

** PWl: DISMOUNT COMPLETE ** 

>1 

>1 EXAMPLE 2: Use FW Driver with FLX 

>i 

>FWU P\71:/RX02/NAME=DY IRUN FWU FROM MCR LEVEL TO : 

> J SET UP FOR FLX RX02 USAGE 
>FLX Dn:/ZE/RT i INITIALIZE PT~11 DIRECTORY 
>FLX DY1:/RT=C11,10]*.MAC iBACK UP MACEO SOURCE FILES 
>FLX DY1:/LI/RT "LIST RT-11 DISK DIRECTORY 

• • 

(FLX Prints Listing) 

• • 

>FWU DY:/NAME=FW iCEiANGE NAME BACK TO EW: 

>l 

>1 Exainple 3: Set up Winchester Disk Parameters 

>i 

>FWU m2:/HD=8/ST=17/SL=2/OF=0/SIZE=34700 iSET fW2: 

> iimJCHESTER TO Q2040 
> 



IV - 36 



3000669/D 

G. FWU MESSAGES 

This section contains a listing of FWU messages with explanations and possible 
action to be taken by the user. 

EMJ — Missing Device Specifier 

Operation requires device specifier (eg., "FVi72:"). Re-enter the conmand. 

FWU — Ccmnand Syntax Error 

Extra or invalid character sequence in command line. Re-enter the conmand. 

FWU — "sw" Is An Invalid Option 

The cption /sw is not a valid FWU switch. Re-enter the conmand. 

FWU — Option "sw" Has Invalid Argument 

Invalid switch value. Re-enter the conmand. 

FWU — Invalid Option Combination 

Two switches cn the same command line conflict (exarrple: /RX02 and /IBMO). 
Re-enter the conmand. 

FWU — Device dduu: Not In System 

The device is not in the device tables. This error could also be printed if 
the symbol table used v^en the FWU task was built does not match the 
Executive in memoiy. Check the device table (MCR DEV conmand) > 

FWU — Device dduu: Already In System 

An attenpt was made to rename a device v^en that device was already present. 
Choose another menraonic and re-enter the conmand. 

FWU — dduu: is Attached 

Certain operations may not be performed if the device is attached ty sane 
other user. The FWU check for attaclied device alleviates the problon of the 
program getting "stuck" while waiting for the other user to finish using the 
device. 
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FWU — dduu: is Mounted 

Certain operations raay not be performed if a volume is mounted on tlie 
requested device. Dismount the volume and retry the operation. 



FWU — dduu: is Not an FW 

The specified operation is valid only for an FV^ unit. Re-enter the command. 

FWU — dduu: is Not a FILES-11 Device 

Certain cperations are valid only for file structured units. Re-enter the 
command. 

F\kj — dduu: is Not a Floppy 

Certain operations are valid only for FW floppy disk units (exairple: /FO). 
Re-enter the command. 



FWU — dduu: is Not a VJinchester 

Certain operations are valid only for Fi; VJinchester units (example: /ST). 
Re-enter the command. 



FWU — Directive Execute Error nnnnn 

The ccmmand was accepted, but some error occurred while executing an RSX-llM 
directive. Consult the I/O Operations Reference Fianual for the meaning of 
nnnnn. The value printed is the positive decimal equivalent of tlie hj^fj 
order byte of the error cede. Correct the problem, then retry the camiand. 

dduu: /Format — Continue? (Y/N): 

This message is printed before initiating a diskette formatting operation. 
If the desired diskette is loaded into the drive, respond "Y<CR>". Else 
enter 'TSI<CR>" or just "<CR>" to cancel the format operation. 

** Begin Formatting ** 

This is an informational message indicating that the FW utility is 
initiating a format operation. No user action is required. 

dduu/Verify — Continue? (Y/N ) : 

This message is printed before initiating a volume read check operation. If 
the desired volume is ready, respond "Y<CR>". Else enter "N<CR>" or just 
"<CR>" to cancel the verify operation. 
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** Begin Verification ** 

This is an informational message indicating that the FWU utility is starting 
a volurre verification. No user action is required. 

Veri:fy Error Starting at LHST nnnnn 

This message is printed whenever a block scan fails. The utility proceeds 
to rescan the blocks one at a time following this message. No user action 
is required. 

Block Read Error at LBN nnnnn 

This message is printed to identify the specific block (s) at Which a block 
scan failed. No user action is required. 

dduu:/Copy to Output Device: 

This message is printed before initiating a ccpy operation. Respond with 
the output device desired or else type to abort the ccpy. 

Enter Volume Name (1-6 Alpha Characters): 

This message is printed v^en a copy operation requires a volume name 
identifier. Respond with the desired name or else type '^Z to abort the 
copy. 

Verify Copied Data Online? (Y/N) : 

This message is printed ty the ccpy function to determine v^ether or not to 
read copied data back into memory. Respond accordingly or else type "Z to 
abort the operation. 

Mount Input Volume nnnnn and Type <CR>: 

During a volume restoration, a new irput volume is required. Ijoad the 
indicated volume and then respond, or else type "Z to abort the copy 
operation. 

Volume Header Read Failure nnnnn 
<CR> to Preceed, ''Z to Abort: 

The volume header is not readable. Respond to the request ty making the 
volume ready or aborting the operation. 
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Vvfrong Volume Name 

<CR> to Preceed, to Abort: 

The volume name entered does not match the ac±ual name on the volume. 
Determine v^iich is the problem, then retry or aibort the operation. 

Wrong Volume Number 

<CR> to Proceed, '^Z to Abort: 

The volume sequence is incorrect. Load tlie correct volume or abort the 
operation. 



*Warning* — Mismatched Number of Output Blocks 
<CR> to Proceed, '^Z to Abort: 

This message indicates that the size of the volume being restored disagrees 
with the size of the volume that was backed up. In general, this is an 
attempt to restore a backed-up volume to an incorrect device. Determine the 
probloTi and respond accordingly. 

Type <CR> \^lhen Input and Output Devices are Ready: 

Tliis message is printed before initiating a block-for-block copy (no volume 
sequence) operation. Respond with a <CR> v^en both devices are ready or 
else type '^Z to abort the ccpy operation. 

Mount Output Volume nnnnn and Type <CR> : 

This message is printed when a new pseudo-tape ouput volume is required ty a 
copy operation. Respond <CR> vs^en the output volume is rea<^, or type "Z to 
abort the ccpy operation. 

Volume Lable Write Failure nnnnn 
<CR> to Proceed, "Z to Abort: 

The cuput volume is not ready, write protected, or faulty. The value of 
nnnnn is the driver error code. Determine the problem and respond 
accordingly. 

Input Device Error nnnnn 

'^Z to Abori:, <CR> to Continue, R to Retry: 

The input volume is faulty. Respond to the request based on the value of 
nnnnn vAiich is the driver error code. 
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Output Device Error nnnnn 

"Z to Abort, <CR> to Continue, R to Retry: 

The output volume is faulty. Based on the error code, correct the problem, 
continue, or abort the cc^y cperation. 

Read Check Error nnnnn 

'^Z to Abort, <CR> to Continue, R to Retcy: 

An attempt to read back a block just written has failed. If retry is 
selected, the write will be re-atteiripted, fol loved ty another read-back 
attenpt. If continue is selected, the copy qperation will proceed. Else 
the operation is aborted. 

Data Verification Error 

The data read back from the output volume does not agree with that saved in 
inemory (just written). If this message is printed after a read check error, 
the output volume disagrees with the original volume at the point noted. If 
this message prints under any other circumstance, the carputer's memory is 
faulty or the ouput device has indicated a successful read-back of invalid 
data (indicating a controller or drive failure). 
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V. EW: DRIVER FUNCTIOSfS 



The information in this cihapter supplements that provided in the RSX-llM I/O 
Drivers Reference Manual. The FVJ driver provides the same functions as other 
disk drivers, plus additional functions required for device-specific operations. 

Throughout this document, the word "device" is used in the RSX-llM context, 
meaning a device-unit ccrribination, such as "FWO", or "DYl". This is not to be 
confused with the PDP-11 Peripherals Manual interpretation of "device" as a 
controller with (an) attached peripheral unit(s). 

A. THE GLUN$ (GET LUN INFORMATION) MACRO 

Word O of the buffer returned by the GLUN$ macro contains the ASCII value of the 
physical device name (ie., "FW"). 

Word 1, lew order byte contains the unit number of the associated device. This 
is RSX's interpretation of unit, not the device controller's. Thus if tvvo 
controllers are present, each having four physical units, the unit number 
returned for physical unit 1 of the second controller will be 5. 

Word 1, high order byte is a resident flag fcyte vAiich will be returned as 200 
octal if the driver is resident, or as if the device is not loaded. 

Vford 2 is the device characteristics wDrd with bit values as defined for all 
disks. 

Word 3 lew order fcyte contains the high 8 bits of the device size in 512-byte 
blocks. The high order byte is meaningless. 

Word 4 contains the lew 16 bits of the device size in 512-tyte blocks. 

Word 5 contains the logical block size in bytes, vvhich is 512(10) for all disk 
devices . 



NOTE: The I/O Drivers Reference Manual is INCORRECT in stating that Words 3 and 
4 are undefined. In fact, these vords contain the device size for any disk 
device, as noted in the Guide to Writing an I/O Driver. 
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B. STANDARD QIO FUNCTIONS 

The fbl laving functions are valid for the FW device, as with all other disk 
devices: 



QIO$ lO.ATT, . . . 

QIO$ lO.DET, ... 

QIO$ lO.KIL, . . . 

QIO$ lO.RLB , . . . , <stadd, size, , Ibnh, lbnl> 

QIO$ lO.RVB, . . . , <stadd, size, , Ibrih, lbnl> 

QIO$ lO.LOV, . . . , <stadd, size, , Ibrih, lbnl> 

QIO$ 10, VILB, . . . , <stadd, size, , Ibnh, lbnl> 

QIO$ lO.WVB, . . . , <stadd, size, , Ibrih, lbnl> 



Attach Device 

Detach Device 

Kill I/O on 
Device 

Read Logical 
Block 

Read Virtual 
Block 

Load Overlay- 
Write Logical 
Block 

VTrite Virtual 
Block 



where: stadd is the starting address of the data buffer (must be on a vvord 
boundary) . 

size is the data buffer size in bytes (must be even and greater tlian 
zero) . 

Ibrih is the high order block. For flcppy units, this must be zero. 

Ibnl is the lew order block. For floppy units, the range depends on 
the diskette format selected. For Winchester units, provision 
has been made to acccmmodate different device sizes, including 
those too large to express in 16 bits. 



The octal values for the above functions are defined by the FILIO$ macro call 
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The Executive processes the Attach and Detach functions without invoking the 
driver. These functions are allowed only for unmounted volumes. 

The Kill I/O function causes all previously queued pending I/O requests (if any) 
for the referenced device to be cancelled. If an I/O transfer is in progress 
when the Kill I/O is executed, the Executive calls the driver to cancel the I/O 
in progress. Most disk drivers ignore this call since the pending operation will 
ccmplete or time out in a short time. 

The Executive (or the file systen, if necessary) processes the Read/Write Virtual 
functions until the starting block nuniber specified is transformed into a logical 
block number, at v^ich time the driver is invoked with the corresponding 
Read/Write Logical function. This implies that a volume is mounted on the 
device, and that a file is cpen on the associated LUN. 

This leaves only the Read/Write Logical functions to be processed ty the driver, 
and then only after the parameters have passed a series of validity checks 
inposed by the Executive. The logical block I/O functions are valid only for 
unmounted volumes, or for mounted volumes v^en the calling task is privileged. 

The Read Overlay function is a special case of the Read Logical function in v^ich 
the Executive adds the starting block of the requesting task to the block number 
specified. This function is used ty the overlay handler built into any task 
Vi^ich is overlaid. The Executive bypasses the privilege checks performed ty 
normal logical block requests and instead checks the block number to insure that 
the request is contained within the limits of the task image on disk. 

NOTE: File structured I/O performed ty typical utility tasks (GET$, PUT$, READ$, 
and WRITE$) is handled ty File Control Service (FCS) routines linked with these 
tasks. FCS routines transform user calls into lO.RVB and lO.WVB QIO directives. 
The OPEISI$, CLOSE$, and other control functions are also handled ty FCS routines. 
In these cases, FCS transforms user calls into GLUN?, ALUN$, and QIO directives 
v»^ich are processed ty the Executive in conjunction with the File Control 
Primitive task (FllACP or other ACP) v^ich performs any required I/O (such as 
directory block accessing) with the lO.RLB and lO.VJLB QIO directives. This 
eliminates the need for the programmer to perform I/O at the QIO level. The 
driver itself needs oily to be concerned with the 10. RIB and lO.WLB functions in 
order to support RSX I/O at the FCS, FCP, and QIO levels. 
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C. DEVICE-SPECIFIC QIO FUNCTIOSfS 

The follcwing device-specific functions are valid for the FW device: 

QIO$ lO.RPB, . . . , <stadd,size, , ,pblk> Read Physical 

Block 

QIO$ lO.WPB, . . . , <stadd, size, , ,pblk> VJrite Physical 

Block 

QIO$ lO.VJDD, <stadd, size, , ,pblk> Write Physical 

Block Setting 
the Deleted 
Data Bit 

QIO$ lO.SPF, . . . , <fmt,hcst,ofsl,ofhdsh,dszl,cph> Spiecify Device 

Format Parameters 

QIO$ 10 . SPB ,...,<,,, ofv , strk , ntrk> Format Tracks 

QIO$ lO.STC, . . . Set Media Density 

v^ere: pblk is the physical block to be accessed. The driver constructs the 
cylinder, head, and sector of the start of the data transfer 
according to the currently defined device parameters. 

fmt is the format control word. Six bits of this word are used. 

They correspond exactly to the Unit Designator parameter fields 
DS, SL, and IL documented in the FWDOlOO/FWDllOO Disk Drive om 
Manual, Chapter III F. The other bits are masked out fcy the FW 
driver. 

host is a vord containing a value defining the number of sectors/track 
in the low order byte and the number of sectors/track in the high 
order byte. These values are used in processing the Physical 
Block I/O functions. 

of sh is a 16-bit value defining the 1cm order of the block offset to 
be applied to read/write logical block operations. This is 
normally zero. 

ofhdsh is a WDrd containing a value defining the high order 8 bits of 
the device size in the low order byte and the high order 8 bits 
of the block offset in the high order byte. 



dszl is a 16-bit value defining the lew order of the number of 
512-tjyte block:s on the device. 

cph is a VADrd defining the number of cylinders per head on the 
device. 

ofv is a WDrd defining the offset to be performed during a format 
operation and corresponds exactly to the Head Step and Switch 
Offsets parameter described in the FWDXIOO OEM Manual. 
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strk is a vord defining the starting track to fonnat. 

ntrk is a WDrd defining the number of tracks to forrrat. 

All of the above functions are valid for unmounted volumes only. The particular 
I/O function code values are defined ty the SPCIO$ macro call. lO.RPB, lO.WPB, 
lO.WDD, and lO.STC are used by DXDRV and DYDRV. lO.SPF and lO.SPB are actually 
magtape control function codes whose mnemonics were borrowed so that alterations 
to the RSXMAC.SML macro library would not be necessary to support the FW 
driver-specific functions. The octal values corresponding to these codes are 
subject to c±iange from time to time, but present assignments are documented in 
the RSX-11 I/O Operations Reference Manual (in an i^pendix). 

The Read/Write Physical functions allav access at the sector level for floppy and 
Winchester units. No sector interleaving or track offsetting is performed by the 
driver or controller. If a physical block I/O request specifies a length greater 
than the sector size, consecutive physical sectors will be read/ written. The 
controller updates the sector to access without any interleaving or track offset 
considerations . 

The physical block number specified represents a value that is converted frcm an 
unsigned single precision number to a head number, cylinder number, and sector 
number by using the heads/cylinder and sectors/track parameters currently in 
effect for the selected drive. The driver does not actually knew if these 
parameters correspond to the media loaded in the drive, but simply performs 
algebraic operations yielding a value in head, cylinder, and sector from the 
specified block (sector) numiber supplied by the user. The cylinder number is the 
most significant value in the calculation, the head number next, and the sector 
number the least significant. If there is only one head per cylinder on the 
referenced drive, the formula reduces to a calculation of track and sector. 

For RXOl and RX02 formats, the mapping results in exactly the same track and 
sector as would be arrived at by the DX or DY (DEC-supplied) drivers, since there 
is only one head per cylinder for these formats. Application software using the 
Read/Write Physical I/O functions originally written for RXOl or RX02 floppies 
will perform in a transparent manner using the FW driver instead of the DX or DY 
driver. 

The Specify Format function is provided in order for an application program to 
dynamically set the assumed format for physical block I/O operations on unmounted 
volumes. The FWU utility also uses this QIO. Caution should be observed when 
executing a Specify Format, as parameters passed to the driver v\^ich do not 
correspond to the actual format of the media loaded in the drive will cause 
subsequent I/O operations to either fail or else produce results other than those 
desired (eg., corruption of a volume). 

The Format Track function is used to initialize the control and data fields of a 
floppy diskette. A diskette may be initialized to RXOl, RX02 or any of a variety 
of IBM formats, according to the last Specify Fonnat operation performed. It 
should be mentioned that this function is NOT equivalent to the Set Media Density 
function iirplemented for the DY driver. The latter simply fills data fields with 
either double density or single density data. By contrast, the Format Track 
operation of the FW driver is able to write nev sector headers on tlie device, 
thus allowing a diskette to be refomatted among RXOl, RX02, and IBM double 
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density fomnats. By using the Fonnat Track capability of the FW driver, a 
diskette v^ose original sector header data has been corrupted by a faulty drive 
or other error condition may be restored to a usable condition (the RXOl and RX02 
cannot reformat diskettes). 

The Set Media Density function is provided for corpatibility with the DY driver. 
This function returns a success condition v^en invoked. The purpose of this 
function for the DY driver is to allcw diskettes to be initialized to double or 
single density (data fields only) . Since the FWU utility provides the 
capability of formatting diskettes, and since a wider variety of diskette formats 
is allowed by the FV7 driver (thus rendering the Set Media Density function 
inconplete) , the NO-OP interpretation was deemed to be the most useful one for 
our purposes. 
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D. QIO FUNCTICN MODIFIERS 

Any of the standard or device-specific QIO functions my be modified by the 
inhibit retry (IQ.X) and/or diagnostic (IQ.UMD) subcodes. The octal values for 
these subcodes are defined by the FILIO$ macro call. The prefix for these 
modifying subcodes is an abbreviation for "I/O Qualifier". 

The IQ.X subcode indicates that the operation is to be performed without retry. 
That is, of an error is detected by ttie controller, no attempt will be made to 
repeat the operation. 

The IQ.UMD subcode specifies that the operation is to be terminated ty passing 
the controller registers to the calling task, and that no error analysis is to be 
performed by the driver. The driver always returns the IS.SUC caipletion code in 
the I/O status block after conpleting a transfer function. If the operation did 
not involve a transfer, no registers are passed. If diagnostics are not 
supported by the Executive, the specified operations will be performed in the 
normal manner, and the subcode will be ignored. 

The folloving are exanples of usage of transfer operations with subcode 
modifiers: 

QIO$ 10 . RPB i IQ .X, . . . , <BUFF, 128 . , , , 494 . > Read Physical 

with no Retry 

QIO$ lO.RLBilQ.XilQ.UMD, . . . , <BUF,1000, , 0, 1> Diagnostic Read 

with no Retry 
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E. I/O AND RELATED ERROR COSfDITICN PROCESSING 

The infonration in this section was included in order to accurately describe the 
processing of an I/O request and related status return codes, since it is not 
available frcm any other source. The error codes reported by the FVV driver were 
designed to be consistent with the standardized error codes used by other 
drivers. A ccmplete listing of the values presently assigned to the syiribolic 
codes itemized below is contained in the RSX I/O Operations Reference Manual (in 
an Appendix ) . This is the definitive source for function codes and error return 
codes. 

As with any other directive (ENTT), the QIO$ macro is processed by the directive 
dispatcher. If the directive dispatcher determines that the directive parameter 
block is valid, the directive is passed to the QIO directive processor. If the 
QIO directive processor determines that the information in the standard poriiion 
of the parameter block is valid for the related device, the success return 
(is. sue) is returned to the calling task, and processing continues. Otherwise, 
the operation is teminated. 

The jBollOAdng status conditions may be returned to a task by the directive 
dispatcher or QIO directive processor in the Directive Status Word ($DSW): 



IS. sue 


Directive accepted, request in progress 


lE.ADP 


Invalid I/O status block specified 


lE.IEF 


Invalid event flag number specified 


lE.IIU 


Invalid logical unit number specified 


lE.SDP 


Invalid data parameter block 


lE.um 


Unassigned logical unit number (LUN) 


lE.HfrJR 


Hardware driver not resident 


lE.UEN 


No pool space for I/O packet or AST 



If the QIO$ directive was accepted thus far, an I/O packet is created to store 
the request parameters, and the specified event flag (if any) is cleared. The 
QIO directive processor then performs more checks on the I/O request. In certain 
cases, the request is ccmpleted by the QIO directive processor, so the driver is 
not called. 

The following errors may be returned ]y/ the QIO directive processor in the I/O 
status block: 

IS. sue Directive ccmpleted successfully 

(This code is returned immediately only 
if the Executive processes the request 
without calling the driver, such as v\hen 
the function is lO.KIL. ) 

IS.PND Operation is pending in the I/O queue 

(This is the normal return. ) 
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lE.PRI Privilege violation 

IE. IPC Invalid function for device 

lE.OFL Device offline 

lE.SPC Buffer space not within calling task limits or 

zero buffer length 

IE .NOD No pool space available 

IE. BYT Odd byte starting address or length 

lE.OVR Illegal overlay request block nuniber 

lE.AIN File alreacfy accessed on LUiSf 

lE.NIN Un~as signed LUSf 

IE. BAD Bad calling parameters 

After the QIO directive processor returns one of the above values to the calling 
task, the calling task is eligible for execution. If the IS.PND code was 
returned in the I/O status block, the specified event flag (if any) resnains 
clear. Otherwise, it is set. 

Assuming that the IS.PND value was returned iMTvediately, the request packet is 
now in the I/O queue. VJhen the driver dequeues the request, further checks are 
performed by Executive routines before the driver processes the request. The 
following error codes may be returned in the I/O status block if the Executive 
conpletes the I/O request: 

IS. sue Directive processed, function ccnplete 

(This happens only if the request was 
10 .ATT or lO.DET. ) 

lE.PRI Privilege violation 

lE.DAA Device already attached 

lE.EaslA Device not attached 

lE.IFC Illegal function under present conditions 

IE .ABO Request aborted by user or Executive 

(This happens v\hen a Kill I/O has been 
executed and the I/O request was still 
in the I/O queue.) 

If the Executive checks were corpleted sucessfully and the operation is still 
pending, the request is either passed back to the driver or to the file system 
(FCP). If the function is passed to FCP, file syston errors are possible. We 
will not enumerate these here, as they are documented elsev^^ere. If the driver 
regains control of the I/O request, driver processing begins. 
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The follcwing error codes my be returned in the I/O status block the FW driver 
(note that other error codes are possible fron other drivers; these are specific 
to the FW driver): 

IS. sue Cjjeration successfully cotpleted. If the operation v;as a 

transfer function, the byte count is returned in the second I/O 
status word. 

IS.WDD Saine as above, but lO.RPB operation resulted in the reading of at 

least one sector of data with the deleted data address mark. 

lE.PRI Privilege violation. The FW driver attenpts to insure the 

integrity of mounted volumes by disallcwing physical block 
reading and writing, fomatting, or parameter setting if the 
device is mounted. 

lE.IFC Illegal function code. This happens if the actual function was 

legal but the sub-function bits were incorrect. As an exanple, 
the lO.RWD control functon has the same function code as lO.SPF 
but different sub-function bits. It must therefore be detected. 
Alternatively, the function is valid only for flcppy disk units 
and the referenced drive was a Winchester. 

lE.ENR Device not ready. This error indicates that the controller 

detected a drive not ready condition or that an operation could 
not be ccmpleted in a reasonable amount of time. The driver 
makes different assumptions about v^at is reasonable based on 
v^ether the referenced unit was a flcppy or a Winchester. 

lE.FHE Fatal hardware error. This error indicates that an illegal error 

status was returned ty the controller upon completion of an 
operation or that the controller cannot conmunicate with the 
physical device unit. 

lE.VER Unrecoverable error. This is the general error code used ty 

drivers to indicate media problems. Usually, this means that the 
equivalent of a parity error was detected ty the controller. For 
floppy disk devices, the actual error could be unexpected media 
density or sector length, invalid sector header data, invalid 
checksum following the data portion of the sector, or unreadable 
media. For Winchester units, the flaw map may be unreadable or 
the media is unreadable. 

lE.BLK Bad block number. This error is detected ty the controller if 

the logical block specified for the start of a transfer is 
invalid, or ty the driver if an invalid physical sector number 
(larger than 16 bits) is specified for a physical block I/O 
request. 

IE. BAD Bad Parameters. This error is returned if the controller detects 

invalid calling parameters. This could be the result of 
specifying a media format inconsistent with the media loaded in 
the referenced drive during a physical block I/O request v^en the 
request results in the passing of an invalid head, cylinder, or 
sector number to the controller ty the driver. 
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lE.OFL Device offline. This error is returned if the controller 

determines that the referenced drive is physically not present. 

lE.WLK Drive writelocked. For flcppy units, the media my be write 

protected by means of a notch cut at the back of the diskette. 
The controller returns this error if a diskette is loaded in the 
drive but the drive indicates that the notch was present 
(uncovered) v^en a write operation was atteirpted. 

lE.BOV End of volume. This error is returned by the controller if a 

transfer request results in media overrun (ie., the start of the 
transfer was accessible but the end overflowed the limits of the 
device. 



NOTE: An I/O status block must be present in order for a task to determine if 
the I/O request completed successfully. If a wait-for (WTSE$) is issued, the 
task has a positive assurance that the directive was canpleted, but not that tlie 
request was ccxipleted successfully. Assuming that the wrSE$ directive was valid, 
a success value is ALWAYS returned for tlie wait-for in the directive status word 
($DSW). This is NOT an indication that the I/O request is completed 
successfully; only that the wait-for condition has been satisfied. The task must 
examine the status block specified in the QIO directive to find out the result of 
a QIO operation. 

Unfortunately, it is impossible for a program to tell whether an error was 
reported by the Executive or by the driver if the directive was processed to the 
point at vhich an I/O packet was created for the request because a task may not 
have an opportunity to execute instructions between the time that a directive is 
issued and its coipletion. Since seme of the error codes reported ty drivers are 
the same as sane of the error codes reported fcy the Executive, this is a 
limitation of RSX-llM. By inspection of the error code list, one can easily see 
that all of the directive error codes are assigned. More accurate reporting of 
error conditions ty a driver to a task is therefor not possible. 



F. DRIVER EOTRY POINTS 

Originally, RSX-llM was designed to be a real-time, priority-driven operating 
system suitable for use in process control (industrial) environments. 
Accordingly, drivers reported errors immediately so that a task could not get 
stuck while performing I/O if it executed a wait following the issuance of a QIO$ 
directive. Today's typical RSX-llM user, however, chooses the operating systan 
(because of its multiuser capabilities) for use in a timesharing environment. 
Over the years, more and mDre timesharing features have been incorporated in the 
Executive as Sysgen options in order to better fit the needs and wishes of 
custaners. Along with these, changes in the operation of drivers were required. 

Following the original design goals of RSX-llM, drivers were constructed to have 
four independent entry points. These are: 

Initiator Called ty the Executive to start an I/O operation. 

Cancel I/O Called by the Executive whien a task is aborted or an I/O kill 

directive is issued ty a task. 
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Fewer Fail Called \/Aien the system is booted or after a power fail to 

initiate the driver to an idle state and corplete fbmierly 
pending I/O. For terminals, this entry enables input interrupts. 

Timeout Called as an absolute protection mechanism in order to recover 

form the circumstance in vs^ich an I/O operation is initiated but 
does not ccrriplete within a reasonable amount of tame. 

In previous releases of RSX-llM, a disk I/O operation in progress vhen a power 
fail occured would always terminate with an error conpletion code following power 
fail recovery because the related drive would not be immediately ready upon power 
up. With the advent of Version 3, drivers were changed to special case I/O 
operations in progress after recovery from a power fail, resulting in the Patient 
Power Fail Recovery feature. To inplement this feature, the power fail and 
timeout entry have become interrelated. 

According to the new scheme, if an operation is pending when a power fail occurs, 
and if power fail recovery was included as a Sysgen option, the driver will retry 
the operation using the timeout entry point as an initiator until the drive has 
had enough time to spin back up to speed. This logic handles the case in v^ich 
an operation is in progress, but not the case in v\^ich an operation is initiated 
sooi after power fail recovery occurs (note that a task does not know vhether or 
not a power fell has occurred unless it issues the SPRA$ directive). 

To solve the general case for timesharing users, the FW driver has a provision 
for complete power fail recovery (P$$WFW) v^ich is independent of the Sysgen 
definition of power fail recovery (P$$RFL) . Since the startup program (SAV) 
calls drivers at the power fail entry point regardless of the definition of 
P$$RFL, and since the load MCR function (LOA) does the same, it is possible to 
incorporate this feature without actually defining the Sysgen power fail support. 

The definition of P$$WFW causes the first operation after boot or load (or 
powerfail recovery if P$$RFL is also defined) on each FW drive to be special 
cased by the FW driver. If the drive-not-ready return code is desired instead of 
the possible long delay in completing the first operation on a drive, do not 
include P$$WEW when the driver is assembled. Otherwise, include this definition 
( see later section) . 



H. PROGRAMMING GONSIDERATIOJS 

The operation of the FV7 driver is very similar to that of most other RSX-llM file 
structured devices. However, a fev points may be vrorth mentioning here. 

1) Due to the relatively long time required to perform an operation on floppy 
disk units (up to 10 seconds for a 32K-WDrd format conmand), the FW driver 
processes the Kill I/O command instead of ignoring it. This is done by means of 
the timeout entry point. An operation in progress vhen a task is aborted (Kill 
I/O performed by the Executive) or v\^en the lO.KIL directive is issued ty a task 
will coitplete within one second of the I/O Kill. 

2) The FlVD controller does not possess a Buffer Address hardware register. It 
is therefore not possible to report the actual length of and I/O transfer in the 
I/O status block. The driver therefore sets the transfer length to the request 
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length if the cperation vas successful/ or to zero if the operation failed. Some 
part of the user buffer may have been filled or written even if the status block 
indicates that zero bytes were transferred. This does not affect the cperation 
of DEC-supplied programs since they do not examine the reported transfer length 
on block oriented devices and they usually terminate upon encountering a hardware 
error condition. 

3) The DEC RXOl format and the IBM single side single density diskette formats 
are the same, physically. Hovever, the DEC RXOl format inplies sector 
interleaving whereas the IBM format does not. Sector interleaving means tliat 
every other sector is skipf)ed v*hen a block is accessed (block equals (4) 128-byte 
sectors). This means that the actual transfer rate is effectively twice as slov 
with the DEC format as it would be with the IBM format. If a diskette is written 
with tlie IBM format/ the performance on the user's system will be better than it 
would be using the DEC format, but the diskette will not be readable using an 
RXOl or RX02 drive with the DX or DY driver. Actually, the diskette could be 
read using IMP, but the data would be "scrambled". The same applies to use of 
RX02 formatted diskettes with interleaving disabled (FMJ FW:/RX02/IL=0 ccmmand). 

4) When using the Physical Block I/O functions with IBM double density formats, 
cylinder zero is a special case. Instead of having double density data with 
potentially 512-byte sectors, the first cylinder has a fixed format of 128--byte 
sectors. The driver does not take this into consideration v^en calculating the 
parameters to pass to the controller for sectors on this track. The result is 
that invalid parameters may be passed to the controller v^hen accessing sectors on 
cylinder zero. 

The design of the driver was such that it would be easy for a programmer to 
construct the physical block number to pass to the driver without his taking 
track zero into account either, according to the following formula: 

pblk = (cylder*spc) + ( (head-l)*spt) + (sector-1) 

where: pblk is the starting physical block (sector) number 



cylder is the physical cylinder (starting with zero) 



spc 



is a constant defining the number of sectors per 
cylinder 



head 



is the physical head number (starting with one) 



spt 



is a constant defining the number of sectors per 
track 



sector is the sector number (starting with one) 
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If the number of heads per cylinder is one, each track is one cylinder 
(spt=spc), so the formula reduces to: 

pblk = (track*spt) + (sector~l) 
where: track is the track number (starting with zero) 

Alt}iough the formula may look coirplicated/ the effect is that the drive surface 
is considered to be consecutive sectors starting with sector zero and ending with 
the last logical sector on the device (in the case of IHyi floppy units, there is 
a "hole" on track zero) . It is tlius xx>ssible for a program to calculate the 
address of tJie current operation by sinple addition of the prior operation's 
starting sector and tiie sector offset between the prior operation and the current 
operation. 
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